Contexto global

AttachAddInAsync

Variante de sintaxis: Por ubicación

Sintaxis:

AttachAddInAsync(<Ubicación>, <Nombre>, <Tipo>, <TipoAdjunto>)

Parámetros:

Tipo: Cadena.
La ubicación del componente externo.
Se puede utilizar lo siguiente como ubicación:

• ruta al archivo del componente externo en el sistema de archivos (no disponible en el cliente web); no es un archivo ZIP;
• nombre completo de la plantilla que almacena datos binarios o un archivo ZIP;
• URL del componente externo almacenado como datos binarios o un archivo ZIP en un formato similar a GetURL.

Tipo: Cadena.
Un nombre simbólico del componente externo adjunto.
El nombre debe cumplir con las convenciones de nomenclatura de script de 1C:Enterprise.

Tipo: AddInType.
El tipo del complemento adjunto.
No se utiliza si el componente está archivado en ZIP.

Tipo: AddInConnectionType.
Tipo de conexión del complemento.

Descripción de la variante del método:

El componente puede ser desarrollado utilizando cualquier tecnología.
¡Atención! La variante del método no funciona en el servidor ni en la conexión externa.

Variante de sintaxis: Por identificador

Sintaxis:

AttachAddInAsync(<ObjectId>)

Parámetros:

Tipo: Cadena.
Identificador del objeto del complemento como un ProgID (Identificador Programático) del registro de Windows (por ejemplo, “AddIn.Scanner”).

Descripción de la variante del método:

El componente debe ser desarrollado utilizando la tecnología COM y estar registrado en el registro de Windows.
Estos componentes son compatibles con los componentes de 1C:Enterprise 7.7.
¡Atención! La variante del método no funciona en el servidor ni en la conexión externa.

Valor devuelto:

Tipo: Promise.
El resultado de la ejecución de la promesa es un valor del tipo Booleano:

• Verdadero – el complemento está adjunto,
• Falso en caso contrario.

Descripción:

Función asíncrona. Inicia la conexión del objeto del complemento a 1C:Enterprise.
Los componentes externos pueden almacenarse en la base de datos de información o en plantillas de configuración como un archivo ZIP o como datos binarios.
Cuando se utiliza el cliente ligero y el cliente web, el complemento debe estar preinstalado.

Disponibilidad:

Cliente ligero, cliente web, cliente móvil, cliente grueso, aplicación móvil (cliente).

Nota:

Los complementos se pueden implementar utilizando la API nativa o la tecnología COM.
El cliente web solo puede utilizar los complementos en la base de datos de información comprimidos en un archivo ZIP.
El cliente ligero solo puede utilizar los complementos en la base de datos de información empaquetados en un archivo ZIP y los complementos ubicados en el sistema de archivos.
El cliente grueso puede utilizar cualquier opción de almacenamiento de complementos. En este caso, si el complemento está instalado utilizando el método InstallAddInAsync, se utiliza el complemento instalado, y si no está instalado, el complemento se recibirá al conectarse.
El servidor puede utilizar todos los complementos. El complemento se almacena en caché por sesión del servidor.

Ejemplo:

&AtClient Procedure Command(Command)     Attach(); EndProcedure &AtClient  Async Procedure Attach()     Attached = Wait AttachAddInAsync(         “CommonTemplate.AddIn”, “AddIn”);     If Attached Then         // Complemento adjunto     Else         Wait InstallAddInAsync(             “CommonTemplate.AddIn”);         Attached = Wait AttachAddInAsync(             “CommonTemplate.AddIn”, “AddIn”);         If Attached Then             // El complemento está instalado y adjunto         Else             // No se puede instalar o adjuntar             // complemento         EndIf;              EndIf;          EndProcedure

Véase también:

Contexto global, método InstallAddInAsync
Contexto global, método LoadAddIn
Contexto global, método BeginInstallAddIn
Contexto global, método AttachAddIn
Contexto global, método InstallAddIn

Disponible desde:

Disponible desde la versión 8.3.18.

Descripción cambiada en la versión 8.3.22.

---